gdk: Rename gdk_event_get_history() to get_motion_history()

It only applies to GDK_MOTION_NOTIFY events, so this is a more descriptive
name. Also add Since tag in docs, and GDK_AVAILABLE_IN_3_94.

diff --git a/docs/reference/gdk/gdk4-sections.txt b/docs/reference/gdk/gdk4-sections.txt
index 8eb95543127ddcac1c2c6df72b4e92d401fc5634..4ad7d32ddf5f8269bf4de32545b30c25738e2996 100644 (file)
--- a/docs/reference/gdk/gdk4-sections.txt
+++ b/docs/reference/gdk/gdk4-sections.txt
@@ -593,7 +593,7 @@ gdk_device_get_position
 gdk_device_get_position_double
 gdk_device_get_window_at_position
 gdk_device_get_window_at_position_double
-gdk_device_get_history
+gdk_device_get_motion_history
 gdk_device_free_history
 GdkTimeCoord
 gdk_device_get_axis

diff --git a/gdk/gdkevents.c b/gdk/gdkevents.c
index e01479e71b3ab152a8913170780997acf1cd7a13..83c676dd7babe581e9fa6c3b948dc28401177b02 100644 (file)
--- a/gdk/gdkevents.c
+++ b/gdk/gdkevents.c
@@ -2567,7 +2567,7 @@ gdk_event_get_axes (GdkEvent  *event,
 }
 
 /**
- * gdk_event_get_history:
+ * gdk_event_get_motion_history:
  * @event: a #GdkEvent of type %GDK_MOTION_NOTIFY
  *
  * Retrieves the history of the @event motion, as a list of time and
@@ -2575,9 +2575,11 @@ gdk_event_get_axes (GdkEvent  *event,
  *
  * Returns: (transfer container) (element-type GdkTimeCoord) (nullable): a list
  *   of time and coordinates
+ *
+ * Since: 3.94
  */
 GList *
-gdk_event_get_history (const GdkEvent *event)
+gdk_event_get_motion_history (const GdkEvent *event)
 {
   if (event->any.type != GDK_MOTION_NOTIFY)
     return NULL;

diff --git a/gdk/gdkevents.h b/gdk/gdkevents.h
index fc50501107dfa3b61c969cd4fbec9b14f4c6da66..de5987a046ce80a6eff42dfcce3018ae7d61a0c4 100644 (file)
--- a/gdk/gdkevents.h
+++ b/gdk/gdkevents.h
@@ -615,7 +615,8 @@ GDK_AVAILABLE_IN_3_92
 gboolean       gdk_event_get_axes      (GdkEvent  *event,
                                         gdouble  **axes,
                                         guint     *n_axes);
-GList        * gdk_event_get_history   (const GdkEvent  *event);
+GDK_AVAILABLE_IN_3_94
+GList        * gdk_event_get_motion_history (const GdkEvent  *event);
 
 G_END_DECLS